home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 6 / The Arsenal Files 6 (Arsenal Computer).ISO / doorware / wcsrok12.zip / INTERBBS.DOC < prev    next >
Text File  |  1996-01-10  |  15KB  |  356 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.      _____________________________________________________________________
  19.  
  20.  
  21.  
  22.  
  23.                                WCS Rook 'em v2.0
  24.  
  25.                              InterBBS Documentation
  26.  
  27.                                   Written by
  28.  
  29.                                  Rob Williams
  30.                                  WCS Software
  31.  
  32.  
  33.      _____________________________________________________________________
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.                           Purpose of This Document
  54.                           ------------------------
  55.  
  56.      This document is to help you set up WCS Rook 'em for InterBBS play.
  57.      This document does not replace the documentation for the game, it is
  58.      ONLY for help in setting up the game for InterBBS.  For questions about
  59.      setting up the game, or how to play, please refer to the WCSROOK.DOC
  60.      file.
  61.  
  62.  
  63.  
  64.                        Files used for InterBBS Play
  65.                        ----------------------------
  66.  
  67.      ROOKIBBS.EXE  -   The main program for InterBBS Play
  68.  
  69.      MASTIBBS.DAT  -   Created with the ROOKIBBS program, it is a list
  70.                        of all the BBSs in the league.
  71.  
  72.      ROOKIBBS.DAT  -   The nightly score file that will be sent from the
  73.                        hub BBS to each of the BBSs in the league.
  74.  
  75.      ROK-nn.DAT    -   The file each of the node BBSs will create, and send
  76.                        to the hub BBS nightly.  The nn will be replaced by the
  77.                        node number of the BBS.
  78.  
  79.      ROOKIBBS.CFG  -   Contains information to create the netmail messages
  80.                        to send to/from your IBBS Hub as well as configuration
  81.                        data for the ROOKIBBS.EXE program.
  82.  
  83.      ROUTE.CFG     -   Used only by hubs, it contains a list of all the
  84.                        Addresses of all the BBSs in the league.  Used to
  85.                        send netmail messages with the nightly ROOKIBBS.DAT
  86.                        files attached.
  87.  
  88.      INTERBBS.DOC  -   This document.
  89.  
  90.  ***************************************************************************
  91.  *****  IT IS VERY IMPORTANT TO READ THIS FILE FULLY BEFORE ATTEMPTING  ****
  92.  *****  TO RUN WCS ROOK 'EM IN AN INTERBBS LEAGUE.                      ****
  93.  ***************************************************************************
  94.  
  95.      DBRIDGE.HLP   -   Help file for people running D'Bridge mailers.  Also
  96.                        helpful as a fallback if you have problems getting
  97.                        the score files automatically processed.
  98.  
  99.      WCSDOORS.FAQ  -   Frequently asked questions about WCS Software Doors.
  100.                        If you are having a problem with either WCS Rook 'em or
  101.                        the InterBBS portion, read this file first for help.
  102.  
  103.  
  104.                        The ROOKIBBS.CFG Configuration File
  105.                        -----------------------------------
  106.  
  107.      The configuration file can for the WCS Rook 'em InterBBS Utility MUST be named
  108.      ROOKIBBS.CFG, and it must reside in the same directory as the door.  The
  109.      configuration file is an ASCII text file with the following format:
  110.  
  111.      Line  1:  Your Net Address
  112.      Line  2:  The To Net Address
  113.      Line  3:  This Door's Name
  114.      Line  4:  Netmail Path
  115.      Line  5:  Incoming File Path
  116.      Line  6:  Name Of Directory To Decompress Incoming Files To
  117.      Line  7:  Name Of Directory Holding Outgoing Files To Be Compressed
  118.      Line  8:  Name Of Directory Holding Compressed Outgoing Files
  119.      Line  9:  Name Of Directory Holding Compressed Incoming Files
  120.      Line 10:  BBS Name - *** MUST MATCH EXACTLY THE NAME IN THE GAME .CFG FILE
  121.      Line 11:  Crash or Hold flag for messages TO HUB - C for Crash, H for Hold
  122.  
  123.      Anything after line 11 is ignored, so you may use that for comments,
  124.      etc.  By default, if the file is created with the SETUP.EXE program,
  125.      the lines following line 11 will contain explanations of each line in
  126.      the file, for documentation purposes.
  127.  
  128.      Listed below is a sample configuration file:
  129.  
  130.      1:999/1
  131.      1:999/1
  132.      WCS Rook 'em
  133.      C:\FD\NETMAIL
  134.      C:\FD\FILES
  135.      INFILES
  136.      OUTFILES
  137.      OUTZIP
  138.      INZIP
  139.      Williams Computer Services BBS
  140.      C
  141.      (**************  IBBS.CFG - Everything after line 11 is ignored. ************)
  142.      Line  1:  Your Net Address
  143.      Line  2:  The To Net Address
  144.      Line  3:  This Door's Name
  145.      Line  4:  Netmail Path
  146.      Line  5:  Incoming File Path
  147.      Line  6:  Name Of Directory To Decompress Incoming Files To
  148.      Line  7:  Name Of Directory Holding Outgoing Files To Be Compressed
  149.      Line  8:  Name Of Directory Holding Compressed Outgoing Files
  150.      Line  9:  Name Of Directory Holding Compressed Incoming Files
  151.      Line 10:  BBS Name - *** MUST MATCH EXACTLY THE NAME IN THE GAME .CFG FILE
  152.      Line 11:  Crash or Hold flag for messages TO HUB - C for Crash, H for Hold
  153.  
  154.      The first two lines should be the same if you are the hub.  Otherwise,
  155.      you should put the hubs net address on line 1 and yours on line 2.
  156.  
  157.  
  158.  
  159.      *****************************************************************
  160.      ***  IMPORTANT!!! - Line 3 should be the same for all         ***
  161.      ***  participants in the game.  If it is different, messages  ***
  162.      ***  will not be transferred correctly!!                      ***
  163.      *****************************************************************
  164.  
  165.      Lines 4 and 5 should reflect your paths that you have set up in your
  166.      mailer for netmail and incoming files.
  167.  
  168.      Lines 6 through 9 should be left as is.  The ones listed above are
  169.      the defaults, and there should be no reason to change them.
  170.  
  171.      Line 10 should match the name in your WCSROOK.CFG file EXACTLY.  If you
  172.      used the SETUP.EXE program, it will make sure the values match.  If
  173.      you edit this file, make sure they remain the same.
  174.  
  175.      Line 11 is either C or H.  If it is a C, then all messages generated
  176.      TO YOUR HUB will have the Crash flag set.  If it is an H, then all
  177.      messages generated will have the Hold flag set.
  178.  
  179.                ************************************************************
  180.                *** Line 11 is only used for messages FROM THE NODE TO   ***
  181.                *** THE HUB.  For the messages from the hub to the node, ***
  182.                *** refer to the ROUTE.CFG file, which has a crash flag  ***
  183.                *** that can be set for each BBS individually            ***
  184.                ************************************************************
  185.  
  186.  
  187.                        The ROUTE.CFG Configuration File
  188.                        --------------------------------
  189.  
  190.      The ROUTE.CFG file for the WCS Rook 'em InterBBS Utility MUST be named
  191.      ROUTE.CFG, and it must reside in the same directory as the door.  The
  192.      purpose of the file is for the hub to specify the addresses of the
  193.      nodes in the game, the filenames that will be created for each node,
  194.      and whether the messages will be crashed out or put on hold.  The
  195.      configuration file is an ASCII text file with the following format:
  196.  
  197.      1:999/1;TEST;C
  198.      ; ---------------------------------------------------------
  199.      ; Format for ROUTE.CFG is:
  200.      ; To_Address;Filename;Crash_Flag
  201.      ; IE:  In line one above, all files in the outfiles directory
  202.      ;      will be ZIP'd into TEST.ROK and sent to 1:999/1 with the
  203.      ;      crash flag set.  If you want to put the message on hold
  204.      ;      to let them poll for it, you would change the C to an H
  205.      ;
  206.      ; All lines beginning with ; are ignored.
  207.  
  208.      You may specify as many lines as you want, and any lines beginning
  209.      with a ; are considered comments (they are ignored)
  210.  
  211.      There are 3 pieces of information specified in each line.  The first
  212.      is the node address, the second is the filename you want created for
  213.      this node, and the third is the crash flag setting.  Putting in a C
  214.      for the crash flag will set the crash flag for this message, and
  215.      anything else will cause the hold flag to get set (the node will have
  216.      to poll to get the message).
  217.  
  218.          *************************************************************
  219.          *** The crash flag in the ROUTE.CFG file is ONLY for      ***
  220.          *** messages FROM THE HUB TO THE NODES.  It is specified  ***
  221.          *** on a BBS by BBS basis, so you can crash files to some ***
  222.          *** BBSs, and put other files on hold.                    ***
  223.          *************************************************************
  224.  
  225.  
  226.  
  227.         Setting up WCS Rook 'em for InterBBS Play - NODE Instructions
  228.         -------------------------------------------------------------
  229.  
  230.      Here are the steps to setting up WCS Rook 'em for InterBBS Play:
  231.  
  232.      1) Find a hub to run the game.  Have them set you up in their BBS
  233.         list, and have them send you the updated MASTIBBS.DAT file.
  234.         (Make sure they send it to all the other BBSs in the league, too)
  235.         Get their node number to enter into the ROOKIBBS.CFG file.
  236.  
  237.      2) Run the SETUP.EXE program, and answer Y to the "InterBBS Play"
  238.         question.
  239.  
  240.      3) After saving the WCSROOK.CFG file (pressing F10), you will be
  241.         asked if you want to setup the InterBBS files.  Answer Y.
  242.  
  243.      4) You will be asked for YOUR Node number, your HUB's node number,
  244.         the directory where your Front Door (or other .MSG compatible
  245.         mailer) netmail messages are stored, and the directory where
  246.         incoming files are kept.  You will also be asked to verify your
  247.         BBS Name (it should match EXACTLY the name in the WCSROOK.CFG file,
  248.         and it will copy the same name you entered before), and whether or
  249.         not you wish to crash messages out or put them on hold for the
  250.         hub to poll for.  The defaults are for FrontDoor running
  251.         on a local C: drive, but the directories are usually similar.
  252.  
  253.      5) Once you finish creating the .cfg files (WCSROOK.CFG and ROOKIBBS.CFG),
  254.         you need to set up a nightly event to create your ROK-nn.DAT file
  255.         to send to your hub.  The command line for this event will be as
  256.         follows:
  257.  
  258.             ROOKIBBS DAILY
  259.  
  260.         After this finishes running, it will create a netmail message with
  261.         a ROK-nn.DAT file attached (zipped up into a nodeaddress.ROK file)
  262.         to send to your hub.
  263.  
  264.      6) Change your mailer batch file so that whenever you get mail, you run
  265.         the following command:
  266.  
  267.            ROOKIBBS INCOMING
  268.  
  269.         What this will do is to scan your netmail directory for a message
  270.         to the game from your host.  It will then unzip the packet, and
  271.         move the new score file into your game directory.  This file will
  272.         be named xxxxx.ROK. (A PkZipped file)  The xxxxx is something your
  273.         hub would like it to be, usually something like an abbreviation of
  274.         your BBS name.  That is all there is to it!
  275.  
  276.  
  277.  
  278.           Setting up WCS Rook 'em for InterBBS Play - HUB Instructions
  279.           ------------------------------------------------------------
  280.  
  281.      Here are the steps to setting up WCS Rook 'em for InterBBS Play:
  282.  
  283.      1) Start up the ROOKIBBS.EXE program, and enter in all the BBSs
  284.         using the "League/Add a BBS" option from the menu.  Continue
  285.         entering in all of the BBSs in the league you want to run.
  286.         Send the MASTIBBS.DAT you just created to all the BBSs in the
  287.         league.  If you add or delete a BBS from the league, make sure
  288.         you send out the new MASTIBBS.DAT file to ALL the BBSs in the
  289.         league.
  290.  
  291.      2) Edit the enclosed ROUTE.CFG file to show all of the nodes in
  292.         your league.  The file name after the node can be anything you
  293.         want, but it should be unique.  If you have questions about the
  294.         format of the ROUTE.CFG file, refer to the previous information
  295.         in this document about the ROUTE.CFG file
  296.  
  297.      3) Run the SETUP.EXE program, and answer Y to the "InterBBS Play"
  298.         question.  (Just like setting up a node above...)
  299.  
  300.      4) After saving the WCSROOK.CFG file (pressing F10), you will be
  301.         asked if you want to setup the InterBBS files.  Answer Y.
  302.  
  303.      5) You will be asked for YOUR Node number, your HUB's node number,
  304.         (which for you as a hub will the the same), the directory where
  305.         your Front Door (or other .MSG compatible mailer) netmail messages
  306.         are stored, and the directory where incoming files are kept.  You
  307.         will also be asked to verify your BBS Name (it should match EXACTLY
  308.         the name in the WCSROOK.CFG file, and it will copy the same name you
  309.         entered before), and whether or not you wish to crash messages out
  310.         or put them on hold for the nodes to poll for.  The defaults are
  311.         for FrontDoor running on a local C: drive, but your directories
  312.         will probably be similar.
  313.  
  314.      6) Once you finish creating the .cfg files (WCSROOK.CFG and ROOKIBBS.CFG),
  315.         As a hub for the game, you need to do 2 things each night.  The
  316.         first is to process your game scores, and the second is to create
  317.         the ROOKIBBS.DAT file to send to all your nodes.  The command line
  318.         for this event will be as follows:
  319.  
  320.             ROOKIBBS DAILY
  321.             ROOKIBBS DAILYHOST
  322.  
  323.         After this finishes running, it will create a netmail message with
  324.         the filename.ROK (PKZipped file) file attached to send to each of
  325.         your nodes.  The filename will be the name you specified in the
  326.         ROUTE.CFG file.  If you specifed that you want the messages
  327.         crashed out (a C on line 11 of the ROOKIBBS.CFG file), the messages
  328.         will have the crash flag set, otherwise they will have the hold
  329.         flag set.
  330.  
  331.  
  332.  
  333.  
  334.                                 Support
  335.                                 -------
  336.  
  337.      If you have problems, I will try and help as best I can, whether you
  338.      are registered or not.  Registered users will get priority over non-
  339.      registered users, though.  You may get help with problems by calling
  340.      Williams Computer Services BBS at (503) 631-8439, or by writing to
  341.      the author at the following addresses:
  342.  
  343.      FIDO     : 1:105/278
  344.  
  345.      Internet : support@wcs.org
  346.                 rwilliam@cybernw.com
  347.  
  348.      US Mail:
  349.  
  350.           Rob Williams
  351.           18370 S. Henrici Road
  352.           Oregon City, OR 97045
  353.  
  354.  
  355.  
  356.